home *** CD-ROM | disk | FTP | other *** search
-
-
-
- Tk_GetFontStruct(3) Tk Library Procedures
-
-
-
- _________________________________________________________________
-
- NAME
- Tk_GetFontStruct, Tk_NameOfFontStruct, Tk_FreeFontStruct -
- maintain database of fonts
-
- SYNOPSIS
- #include <tk.h>
-
- XFontStruct *
- Tk_GetFontStruct(_i_n_t_e_r_p, _t_k_w_i_n, _n_a_m_e_I_d)
-
- char *
- Tk_NameOfFontStruct(_f_o_n_t_S_t_r_u_c_t_P_t_r)
-
- Tk_FreeFontStruct(_f_o_n_t_S_t_r_u_c_t_P_t_r)
-
- ARGUMENTS
- Tcl_Interp *_i_n_t_e_r_p (in) Interpreter to use
- for error report-
- ing.
-
- Tk_Window _t_k_w_i_n (in) Token for window in
- which font will be
- used.
-
- Tk_Uid _n_a_m_e_I_d (in) Name of desired
- font.
-
- XFontStruct *_f_o_n_t_S_t_r_u_c_t_P_t_r (in) Font structure to
- return name for or
- delete.
- _________________________________________________________________
-
-
- DESCRIPTION
- Tk_GetFont loads the font indicated by _n_a_m_e_I_d and returns a
- pointer to information about the font. The pointer returned
- by Tk_GetFont will remain valid until Tk_FreeFont is called
- to release it. _N_a_m_e_I_d can be either a font name or pattern;
- any value that could be passed to XLoadQueryFont may be
- passed to Tk_GetFont. If Tk_GetFont is unsuccessful
- (because, for example, there is no font corresponding to
- _n_a_m_e_I_d) then it returns NULL and stores an error message in
- _i_n_t_e_r_p->_r_e_s_u_l_t.
-
- Tk_GetFont maintains a database of all fonts it has allo-
- cated. If the same _n_a_m_e_I_d is requested multiple times (e.g.
- by different windows or for different purposes), then addi-
- tional calls for the same _n_a_m_e_I_d will be handled very
- quickly, without involving the X server. For this reason,
- it is generally better to use Tk_GetFont in place of X
-
-
-
- Tk 1
-
-
-
-
-
-
- Tk_GetFontStruct(3) Tk Library Procedures
-
-
-
- library procedures like XLoadQueryFont.
-
- The procedure Tk_NameOfFontStruct is roughly the inverse of
- Tk_GetFontStruct. If its _f_o_n_t_S_t_r_u_c_t_P_t_r argument was created
- by Tk_GetFontStruct, then the return value is the _n_a_m_e_I_d
- argument that was passed to Tk_GetFontStruct to create the
- font. If _f_o_n_t_S_t_r_u_c_t_P_t_r was not created by a call to
- Tk_GetFontStruct, then the return value is a hexadecimal
- string giving the X identifier for the associated font.
- Note: the string returned by Tk_NameOfFontStruct is only
- guaranteed to persist until the next call to
- Tk_NameOfFontStruct.
-
- When a font returned by Tk_GetFont is no longer needed,
- Tk_FreeFont should be called to release it. There should be
- exactly one call to Tk_FreeFont for each call to Tk_GetFont.
- When a font is no longer in use anywhere (i.e. it has been
- freed as many times as it has been gotten) Tk_FreeFont will
- release it to the X server and delete it from the database.
-
-
- KEYWORDS
- font
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Tk 2
-
-
-
-